Inside Macintosh: QuickDraw GX Objects /

Chapter 5 - Ink Objects / Ink Objects Reference

Functions / Manipulating Ink Object Properties

GXResetInk

You can use the GXResetInk function to reset the properties of an ink to their default values.

void GXResetInk(gxInk target);

target

A reference to the ink object whose properties you want to reset.

DESCRIPTION

The GXResetInk function resets the color, transfer mode, and attributes of the ink object specified by the target parameter to match the properties of the default ink object:

• No attributes set.
• Color space set to gxRGBSpace with each color component set to 0, which represents black in this color space.
• Transfer mode set to gxCopyMode, with identity transfer mode matrices, color limits of 0 to 0xFFFF (gxColorValue1), and all flags cleared.

The GXResetInk function does not change the target ink's owner count or tag list.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
ink_is_nil

SEE ALSO

Default ink properties are described in the section "The Default Ink Object" on page 5-10.